home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1999 January: Mac OS SDK / Dev.CD Jan 99 SDK2.toast / Development Kits / QuickTime / QuickTime 3 Interfaces & Libs / QTDevWin / CIncludes / TextEncodingConverter.h < prev    next >
Encoding:
C/C++ Source or Header  |  1998-08-21  |  8.4 KB  |  271 lines  |  [TEXT/dosa]
  1. /*
  2.      File:        TextEncodingConverter.h
  3.  
  4.      Contains:    Text Encoding Conversion Interfaces.
  5.  
  6.      Version:    Technology:    Mac OS 8
  7.                  Release:    QuickTime 3.0
  8.  
  9.      Copyright:    © 1994-1998 by Apple Computer, Inc., all rights reserved.
  10.  
  11.      Bugs?:        Please include the the file and version information (from above) with
  12.                  the problem description.  Developers belonging to one of the Apple
  13.                  developer programs can submit bug reports to:
  14.  
  15.                      devsupport@apple.com
  16.  
  17. */
  18. #ifndef __TEXTENCODINGCONVERTER__
  19. #define __TEXTENCODINGCONVERTER__
  20.  
  21. #ifndef __MACTYPES__
  22. #include <MacTypes.h>
  23. #endif
  24. #ifndef __MIXEDMODE__
  25. #include <MixedMode.h>
  26. #endif
  27. #ifndef __TEXTCOMMON__
  28. #include <TextCommon.h>
  29. #endif
  30.  
  31.  
  32.  
  33. #if PRAGMA_ONCE
  34. #pragma once
  35. #endif
  36.  
  37. #ifdef __cplusplus
  38. extern "C" {
  39. #endif
  40.  
  41. #if PRAGMA_IMPORT
  42. #pragma import on
  43. #endif
  44.  
  45. #if PRAGMA_STRUCT_ALIGN
  46.     #pragma options align=mac68k
  47. #elif PRAGMA_STRUCT_PACKPUSH
  48.     #pragma pack(push, 2)
  49. #elif PRAGMA_STRUCT_PACK
  50.     #pragma pack(2)
  51. #endif
  52.  
  53. typedef OSType                             TECPluginSignature;
  54. typedef UInt32                             TECPluginVersion;
  55. /* plugin signatures */
  56.  
  57. enum {
  58.     kTECSignature                = FOUR_CHAR_CODE('encv'),
  59.     kTECUnicodePluginSignature    = FOUR_CHAR_CODE('puni'),
  60.     kTECJapanesePluginSignature    = FOUR_CHAR_CODE('pjpn'),
  61.     kTECChinesePluginSignature    = FOUR_CHAR_CODE('pzho'),
  62.     kTECKoreanPluginSignature    = FOUR_CHAR_CODE('pkor')
  63. };
  64.  
  65.  
  66. /* converter object reference */
  67. typedef struct OpaqueTECObjectRef*         TECObjectRef;
  68. typedef struct OpaqueTECSnifferObjectRef*  TECSnifferObjectRef;
  69. typedef OSType                             TECPluginSig;
  70.  
  71. struct TECConversionInfo {
  72.     TextEncoding                     sourceEncoding;
  73.     TextEncoding                     destinationEncoding;
  74.     UInt16                             reserved1;
  75.     UInt16                             reserved2;
  76. };
  77. typedef struct TECConversionInfo        TECConversionInfo;
  78. /* return number of encodings types supported by user's configuraton of the encoding converter */
  79. EXTERN_API( OSStatus )
  80. TECCountAvailableTextEncodings    (ItemCount *            numberEncodings);
  81.  
  82. /* fill in an array of type TextEncoding passed in by the user with types of encodings the current configuration of the encoder can handle. */
  83. EXTERN_API( OSStatus )
  84. TECGetAvailableTextEncodings    (TextEncoding             availableEncodings[],
  85.                                  ItemCount                 maxAvailableEncodings,
  86.                                  ItemCount *            actualAvailableEncodings);
  87.  
  88. /* return number of from-to encoding conversion pairs supported  */
  89. EXTERN_API( OSStatus )
  90. TECCountDirectTextEncodingConversions (ItemCount *        numberOfEncodings);
  91.  
  92. /* fill in an array of type TextEncodingPair passed in by the user with types of encoding pairs the current configuration of the encoder can handle. */
  93. EXTERN_API( OSStatus )
  94. TECGetDirectTextEncodingConversions (TECConversionInfo     availableConversions[],
  95.                                  ItemCount                 maxAvailableConversions,
  96.                                  ItemCount *            actualAvailableConversions);
  97.  
  98. /* return number of encodings a given encoding can be converter into */
  99. EXTERN_API( OSStatus )
  100. TECCountDestinationTextEncodings (TextEncoding             inputEncoding,
  101.                                  ItemCount *            numberOfEncodings);
  102.  
  103. /* fill in an array of type TextEncodingPair passed in by the user with types of encodings pairs the current configuration of the encoder can handle. */
  104. EXTERN_API( OSStatus )
  105. TECGetDestinationTextEncodings    (TextEncoding             inputEncoding,
  106.                                  TextEncoding             destinationEncodings[],
  107.                                  ItemCount                 maxDestinationEncodings,
  108.                                  ItemCount *            actualDestinationEncodings);
  109.  
  110. /* get info about a text encoding */
  111. EXTERN_API( OSStatus )
  112. TECGetTextEncodingInternetName    (TextEncoding             textEncoding,
  113.                                  Str255                 encodingName);
  114.  
  115. EXTERN_API( OSStatus )
  116. TECGetTextEncodingFromInternetName (TextEncoding *        textEncoding,
  117.                                  ConstStr255Param         encodingName);
  118.  
  119. /* create/dispose converters */
  120. EXTERN_API( OSStatus )
  121. TECCreateConverter                (TECObjectRef *            newEncodingConverter,
  122.                                  TextEncoding             inputEncoding,
  123.                                  TextEncoding             outputEncoding);
  124.  
  125. EXTERN_API( OSStatus )
  126. TECCreateConverterFromPath        (TECObjectRef *            newEncodingConverter,
  127.                                  const TextEncoding     inPath[],
  128.                                  ItemCount                 inEncodings);
  129.  
  130. EXTERN_API( OSStatus )
  131. TECDisposeConverter                (TECObjectRef             newEncodingConverter);
  132.  
  133. /* convert text encodings */
  134. EXTERN_API( OSStatus )
  135. TECClearConverterContextInfo    (TECObjectRef             encodingConverter);
  136.  
  137. EXTERN_API( OSStatus )
  138. TECConvertText                    (TECObjectRef             encodingConverter,
  139.                                  ConstTextPtr             inputBuffer,
  140.                                  ByteCount                 inputBufferLength,
  141.                                  ByteCount *            actualInputLength,
  142.                                  TextPtr                 outputBuffer,
  143.                                  ByteCount                 outputBufferLength,
  144.                                  ByteCount *            actualOutputLength);
  145.  
  146. EXTERN_API( OSStatus )
  147. TECFlushText                    (TECObjectRef             encodingConverter,
  148.                                  TextPtr                 outputBuffer,
  149.                                  ByteCount                 outputBufferLength,
  150.                                  ByteCount *            actualOutputLength);
  151.  
  152. /* one-to-many routines */
  153. EXTERN_API( OSStatus )
  154. TECCountSubTextEncodings        (TextEncoding             inputEncoding,
  155.                                  ItemCount *            numberOfEncodings);
  156.  
  157. EXTERN_API( OSStatus )
  158. TECGetSubTextEncodings            (TextEncoding             inputEncoding,
  159.                                  TextEncoding             subEncodings[],
  160.                                  ItemCount                 maxSubEncodings,
  161.                                  ItemCount *            actualSubEncodings);
  162.  
  163. EXTERN_API( OSStatus )
  164. TECGetEncodingList                (TECObjectRef             encodingConverter,
  165.                                  ItemCount *            numEncodings,
  166.                                  Handle *                encodingList);
  167.  
  168. EXTERN_API( OSStatus )
  169. TECCreateOneToManyConverter        (TECObjectRef *            newEncodingConverter,
  170.                                  TextEncoding             inputEncoding,
  171.                                  ItemCount                 numOutputEncodings,
  172.                                  const TextEncoding     outputEncodings[]);
  173.  
  174.  
  175. EXTERN_API( OSStatus )
  176. TECConvertTextToMultipleEncodings (TECObjectRef         encodingConverter,
  177.                                  ConstTextPtr             inputBuffer,
  178.                                  ByteCount                 inputBufferLength,
  179.                                  ByteCount *            actualInputLength,
  180.                                  TextPtr                 outputBuffer,
  181.                                  ByteCount                 outputBufferLength,
  182.                                  ByteCount *            actualOutputLength,
  183.                                  TextEncodingRun         outEncodingsBuffer[],
  184.                                  ItemCount                 maxOutEncodingRuns,
  185.                                  ItemCount *            actualOutEncodingRuns);
  186.  
  187. EXTERN_API( OSStatus )
  188. TECFlushMultipleEncodings        (TECObjectRef             encodingConverter,
  189.                                  TextPtr                 outputBuffer,
  190.                                  ByteCount                 outputBufferLength,
  191.                                  ByteCount *            actualOutputLength,
  192.                                  TextEncodingRun         outEncodingsBuffer[],
  193.                                  ItemCount                 maxOutEncodingRuns,
  194.                                  ItemCount *            actualOutEncodingRuns);
  195.  
  196. /* international internet info */
  197. EXTERN_API( OSStatus )
  198. TECCountWebTextEncodings        (RegionCode             locale,
  199.                                  ItemCount *            numberEncodings);
  200.  
  201. EXTERN_API( OSStatus )
  202. TECGetWebTextEncodings            (RegionCode             locale,
  203.                                  TextEncoding             availableEncodings[],
  204.                                  ItemCount                 maxAvailableEncodings,
  205.                                  ItemCount *            actualAvailableEncodings);
  206.  
  207. EXTERN_API( OSStatus )
  208. TECCountMailTextEncodings        (RegionCode             locale,
  209.                                  ItemCount *            numberEncodings);
  210.  
  211. EXTERN_API( OSStatus )
  212. TECGetMailTextEncodings            (RegionCode             locale,
  213.                                  TextEncoding             availableEncodings[],
  214.                                  ItemCount                 maxAvailableEncodings,
  215.                                  ItemCount *            actualAvailableEncodings);
  216.  
  217. /* examine text encodings */
  218. EXTERN_API( OSStatus )
  219. TECCountAvailableSniffers        (ItemCount *            numberOfEncodings);
  220.  
  221. EXTERN_API( OSStatus )
  222. TECGetAvailableSniffers            (TextEncoding             availableSniffers[],
  223.                                  ItemCount                 maxAvailableSniffers,
  224.                                  ItemCount *            actualAvailableSniffers);
  225.  
  226. EXTERN_API( OSStatus )
  227. TECCreateSniffer                (TECSnifferObjectRef *    encodingSniffer,
  228.                                  TextEncoding             testEncodings[],
  229.                                  ItemCount                 numTextEncodings);
  230.  
  231. EXTERN_API( OSStatus )
  232. TECSniffTextEncoding            (TECSnifferObjectRef     encodingSniffer,
  233.                                  TextPtr                 inputBuffer,
  234.                                  ByteCount                 inputBufferLength,
  235.                                  TextEncoding             testEncodings[],
  236.                                  ItemCount                 numTextEncodings,
  237.                                  ItemCount                 numErrsArray[],
  238.                                  ItemCount                 maxErrs,
  239.                                  ItemCount                 numFeaturesArray[],
  240.                                  ItemCount                 maxFeatures);
  241.  
  242. EXTERN_API( OSStatus )
  243. TECDisposeSniffer                (TECSnifferObjectRef     encodingSniffer);
  244.  
  245. EXTERN_API( OSStatus )
  246. TECClearSnifferContextInfo        (TECSnifferObjectRef     encodingSniffer);
  247.  
  248.  
  249.  
  250.  
  251. #if PRAGMA_STRUCT_ALIGN
  252.     #pragma options align=reset
  253. #elif PRAGMA_STRUCT_PACKPUSH
  254.     #pragma pack(pop)
  255. #elif PRAGMA_STRUCT_PACK
  256.     #pragma pack()
  257. #endif
  258.  
  259. #ifdef PRAGMA_IMPORT_OFF
  260. #pragma import off
  261. #elif PRAGMA_IMPORT
  262. #pragma import reset
  263. #endif
  264.  
  265. #ifdef __cplusplus
  266. }
  267. #endif
  268.  
  269. #endif /* __TEXTENCODINGCONVERTER__ */
  270.  
  271.